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User Function Registration APIs 


The user function registration APIs manage the registration and usage information for functions. To help 
you manage your systems, the user function registration APIs provide a mechanism for registering 
functions and controlling which users are allowed to use those functions. The control of user functions, 
however, is not a replacement for securing resources. Users who are not allowed to use a particular function 
are not prevented from accessing a resource through another interface. 


The user function registration APIs are: 
e Change Function Usage Information (QSYCHFUI, QsyChangeFunctionUsageInfo) changes the 
usage information for a function, such as which user profiles are allowed to use a function. 


e Check User Function Usage (QS YCKUFU, QsyCheckUserFunctionUsage) whether a user is 


allowed to use the specified function and returns an indication of whether the user is allowed to use 
the function. 


e Deregister Function (QSYDRGEN, QsyDeregisterFunction) removes a function and all associated 
usage information from the registration facility. 


e Register Function (QSYRGEN, QsyRegisterFunction) registers a function with the registration 
facility. 


e Retrieve Function Information (QSYRTVFI, QsyRetrieveFunctionInformation) retrieves 
information about one or more functions. 


e Retrieve Function Usage Information (QSYRTFUI, QsyRetrieveFunctionUsagelInfo) retrieves 
usage information for a function. 


e Retrieve User Function Information (QSYRTUFI, QsyRetrieveUserFunctionInfo) retrieves usage 
settings for a specified user profile for one or more functions. 


Top | Security APIs | APIs by category 


Change Function Usage Information 
(QSYCHFUI, QsyChangeFunctionUsagelnfo) 
API 


Required Parameter Group: 


Function ID Char(30) 
Format name Char(8) 
Function usage information Char(*) 


Length of function usage Binary(4) 
information 


Error code Char(*) 


Default Public Authority: *USE 


Service Program: QSYFNUSG 


Threadsafe: Yes 


The Change Function Usage Information (OPM, QS YCHFUI; ILE, QsyChangeFunctionUsagelInfo) API 
changes the usage information for a function. The usage information for a function indicates which user 
profiles are allowed or not allowed to use a function. 


The usage information is stored with the user profile. To save and restore the usage information, you must 
use the same methods as with other user profile information (Save Security Data (SAVSECDTA) 
command, Restore User Profiles (RSTUSRPRF) command, Restore Authority (RSTAUT) command). 


Authorities and Locks 


API Public Authority 

*USE 
Authority Required 

*SECADM special authority 
Usage Information Lock 

*EXCL 


Required Parameter Group 


Function ID 
INPUT; CHAR(30) 


The ID of the function for which usage information is being changed. 


Format name 
INPUT; CHAR(8) 


The format of the function usage information. 
The valid value is: 


CFUIOIOO Function usage information 


Function usage information 
INPUT; CHAR(*) 


The usage information that is being changed for the specified function. See CFUIO100 Format for 
the definition of the fields for this parameter. 


Length of function usage information 
INPUT; BINARY(4) 


The length of the function usage information. This area must be as large as the format specified. 
Error code 


1/0; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


CFUIO100 Format 


The following table shows the information that must be specified in the function usage information 
parameter when format CFUIO100 is specified. For a detailed description of each field, see Field 


Descriptions. 


| Offset 
| Dec Hex |Type Field 
| 0 0 BINARY(4) Number of usage information entries 


Usage information entry. These fields are repeated for each usage information entry 
returned. 


| CHAR(10) User profile name 
| CHAR(1) Usage setting 


Field Descriptions 


Number of usage information entries. The total number of usage information entries. This value must be 
greater than 0. 


Usage information entries. The entries that contain the usage information. 


Usage setting. Whether the user is allowed to use the function or not. 
The following values can be specified: 

0 The user's previous setting is removed. 

I The user is not allowed to use the function. 


2 The user is allowed to use the function. 


User profile name. The name of the user profile whose usage setting is being changed. The user profile 
must exist. 


Error Messages 


Message ID Error Message Text 

CPF2225 E Not able to allocate internal system object. 

CPF222E E &1 special authority is required. 

CPF228A E Function &1 not registered. 

CPF229B E Operation not allowed for function &1. 

CPF229C E Not all usage information changed for function &1. 
CPF3C21E Format name &1 is not valid. 

CPF3C3C E Value for parameter &1 not valid. 

CPF3C36 E Number of parameters, &1, entered for this API was not valid. 
CPF3CD9 E Requested function cannot be performed at this time. 
CPF3CDA E Registration facility repository not available for use. 
CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 

CPF3C90 E Literal value cannot be changed. 

CPF8100 E All CPF81xx messages could be returned. xx is from 01 to FF. 
CPF9810 E Library &1 not found. 


CPF9872 E Program or service program &1 in library &2 ended. Reason code &3. 


API Introduced: V4R3 
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Check User Function Usage (QSYCKUFU, 
QsyCheckUserFunctionUsage) API 


Required Parameter Group: 


Usage indicator Char(1) 
Function ID Char(30) 
User profile name Char(10) 
Error code Char(*) 


Default Public Authority: *USE 
Service Program: QSYFNUSG 


Threadsafe: Yes 


The Check User Function Usage (OPM, QS YCKUFU; ILE, QsyCheckUserFunctionUsage) API checks to 
see if a user is allowed to use the specified function, and returns an indication of whether the user is 
allowed to use the function. When the check is made, the usage setting for the user, its group, the default 
usage value, and the allow *ALLOBJ indicator for the function are taken into account. Following are the 
steps the system takes to determine the usage indicator for the user to the function: 


1. Is the *ALLOBJ indicator for the function set to 1 and does the user have *ALLOBJ special 
authority? If yes to both, set the returned usage indicator to usage allowed and return. Otherwise, 
continue with step 2. 


2. Does the user have a usage setting for the function? If yes, set the returned usage indicator to the 
usage indicator for the user and return. Otherwise, continue with step 3. 


3. Does the user have any groups? If yes, continue with step 3a. Otherwise, go to step 4. 
1. Repeat the following steps for each group: 


1. Is the *ALLOBJ indicator for the function set to 1 and does the group have 
*ALLOBSJ special authority? If yes to both, set the returned usage indicator to 
usage allowed and return. Otherwise, go to step 3a2. 


2. Does the group have a usage setting for the function? If yes, go to step 3a2a. 
Otherwise, go look at the next group, starting over with step 3al. 


1. Does the group's usage setting allow usage of the function? If yes, set the 
returned usage indicator to usage allowed and return. Otherwise, set a flag 
that indicates a group usage setting is found and go look at the next group, 
starting over with step 3al. 


2. Is the group usage setting found flag set on? If yes, set the returned usage indicator to usage 
not allowed and return. Otherwise, continue with step 4. 


4. Set the returned usage indicator to the default usage value and return. 


Authorities and Locks 


API Public Authority 
*USE 
Function Registration Lock 


*SHRNUP 


Required Parameter Group 


Usage indicator 
OUTPUT; CHAR(1) 


Whether the user is allowed to use the specified function. 
This parameter contains one of the following values: 


I The user is not allowed to use the specified function. 


2 The user is allowed to use the specified function. 


Function ID 
INPUT; CHAR(30) 


The ID of the function to check usage information for. 
User profile name 
INPUT; CHAR(10) 


The name of the user to check for usage to the specified function. 
You can specify the following special value: 


*CURRENT The usage check is made for the user currently running. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Error Messages 


Message ID _ Error Message Text 

CPF2204 E User profile &1 not found. 

CPF2225 E Not able to allocate internal system object. 

CPF228A E Function &1 not registered. 

CPF3C36 E Number of parameters, &1, entered for this API was not valid. 


CPF3C90 E Literal value cannot be changed. 

CPF3CD9 E Requested function cannot be performed at this time. 

CPF3CDA E _ Registration facility repository not available for use. 

CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 

CPF8100 E All CPF81xx messages could be returned. xx is from 01 to FF. 
CPF9810 E Library &1 not found. 

CPF9872 E Program or service program &1 in library &2 ended. Reason code &3. 


API Introduced: V4R3 


Top | Security APIs | APIs by category 


Deregister Function (QSYDRGFN, 
QsyDeregisterFunction) API 


Required Parameter Group: 


1 Function ID Input Char(30) 
2 Error code VO Char(*) 


Default Public Authority: *USE 


Service Program: QSYRGEN1 


Threadsafe: Yes 


The Deregister Function (OPM, QSYDRGEN; ILE, QsyDeregisterFunction) API removes a function and 
all associated usage information from the registration facility. 


Authorities and Locks 


API Public Authority 

*USE 
Authority Required 

*SECADM special authority 
Function Registration Lock 

*EXCL 


Required Parameter Group 
Function ID 
INPUT; CHAR(30) 


The function ID for the function being removed. 
The following can be specified for the function ID: 


generic* All functions IDs that have IDs beginning with the generic string. 


function ID Specific function ID. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Error Messages 


Message ID Error Message Text 

CPF222E E &1 special authority is required. 

CPF228A E Function &1 not registered. 

CPF228B E Function &1 cannot be removed from the registry. 

CPF3C36 E Number of parameters, &1, entered for this API was not valid. 
CPF3C90 E Literal value cannot be changed. 

CPF3CD9 E Requested function cannot be performed at this time. 
CPF3CDA E Registration facility repository not available for use. 
CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 

CPF8100 E All CPF81xx messages could be returned. xx is from 01 to FF. 
CPF9810 E Library &1 not found. 

CPF9811E Program &1 in library &2 not found. 


CPF9872 E Program or service program &1 in library &2 ended. Reason code &3. 


API Introduced: V4R3 
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Register Function (QSYRGFN, 
QsyRegisterFunction) API 


Required Parameter Group: 


Function ID Char(30) 
Function controls Char(*) 
Error Code Char(*) 


Service Program Name: QSYRGENI1 


Default Public Authority: *USE 


Threadsafe: Yes 


The Register Function (OPM, QSYRGEN; ILE, QsyRegisterFunction) API registers a function with the 
registration facility. The function controls provide information to help manage and control the use of the 
function. 


You can update a function entry by reregistering the function (using the replace control key) with new 
values for the function control keys. The registration facility will update the control keys and maintain the 
current list of usage settings that are associated with the function. The following conditions apply to 
updating the function control keys: 


e Function category: This control key is set the first time the function is registered and cannot be 
changed. 


e Function type: This control key is set the first time the function is registered and cannot be 
changed. 


When a function is registered, the registration information is stored using the Exit Point Registration 
Facility. Each function is registered as an exit program within an exit point. The exit point that the function 
is registered in depends on the category of the function: 


e Locally managed client functions within iSeries Navigator are registered in the 
QIBM_QSY_OPNAVCLIENT exit point. 


e Locally managed client functions that are not within iSeries Navigator are registered in the 
QIBM_QSY_OTHERCLIENT exit point. 


e Host functions are registered in the QIBM_QSY_HOSTFUNC exit point. 


e Centrally managed client functions within iSeries Navigator are registered in the 
QIBM_QSY_OPNAVCENTRL exit point. 


e Centrally managed client functions that are not within iSeries Navigator are registered in the 
QIBM_QSY_OTHERCENTRL exit point.%& 


2The Exit Point Registration Facility is used only for storing the function registration information. The exit 
programs within these exit points are never called, so the formats associated with these exit points 
(FCNRO100 and FCNRO200) are never used or documented.*& 


Note: You must use this API and the Deregister Function (QSYDRGEN, QsyDeregisterFunction) API to 
manage the function registration entries. If the Exit Point Registration Facility APIs are used, the results 
will be unpredictable. 


Authorities and Locks 


API Public Authority 
*USE 


Authority Required 
*SECADM special authority 


Function Registration Lock 
*EXCL 


Required Parameter Group 


Function ID 
INPUT; CHAR(30) 


The function ID to register. IBM functions are named QIBM_Qccc_name, where _Qccc is the 
componenet qualifier and ccc is the component identifier, or are named QIBM_wccc_name, where 
_wecc is the component qualifier, w is a character A through I, and ccc is the component identifier. 
The component qualifier is included in IBM function IDs if the function is associated with a 
specific component. Otherwise, IBM function IDs will not contain the component qualifier. 
User-supplied function IDs should not preface their function ID with QIBM. User-supplied 
function IDs should start with the company name to eliminate most problems that involve unique 
names. 


The first character of the function ID must be one of the following: 


A-Z Uppercase A-Z 


The remaining characters in the function ID must be made up of the following characters: 
A-Z Uppercase A-Z 
0-9 Digits 0-9 


Period 


Underscore 


Function controls 
INPUT; CHAR(*) 


The function control fields for managing the function. Any field not specified will be given the 
default value. Refer to Function Control Keys for more information. 


The information must be in the following format: 


Number of variable length records BINARY(4) 
The total number of all of the variable length records. 


Variable length records The fields of the function controls to set. Refer to Format 
for Variable Length Record for more information. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


Format for Variable Length Record 


The following table shows the layout of the variable length record. For a detailed description of each field, 
see Field Descriptions. 


| Offset 
| Dec Hex Type Field 


| 0 0 BINARY(4) Length of variable length record 
| 4 4 BINARY(4) Function control key 

| 8 8 BINARY(4) Length of data 

| 12 C CHAR(*) Data 


If the length of the data is longer than the key field's data length, the data is truncated at the right. No 
message is issued. 


If the length of the data is shorter than the key field's data length and the key contains binary data, an error 
message is issued. If the key does not contain binary data, the field is padded with blanks. 


It is not an error to specify a key more than once. If duplicate keys are specified, the last specified value for 
that key is used. 


Each variable length record must be 4-byte aligned. If not, unpredictable results may occur. 


Field Descriptions 


Data. The value to which a specific function control is to be set. 


Function control key. The function control to be set. Refer to Function Control Keys for more 
information. 


Length of data. The length of the function control value. 


Length of variable length record. The length of the record including this field. 


Function Control Keys 


The following table shows the valid function control keys for the key field area of the variable length 
record. For a detailed description of each field, see Field Descriptions. 


| 1 |CHAR() [Functioncategory 9 9 
[ 2  |CHAR() [Functiontype = = 
| 3 |CHAR(30) [FunctionproducttID = 


5 CHAR(27)_ |Qualified message file name and message identifier for 
function name 


| 6 [CHAR(132) [Function name 
| 7 [BINARY (4) [Function name CCSID 


| 8 oe eo | 
function description 

| 9  |CHAR(I32)[Functiondescription = 

| 10  |BINARY(4)|Function description CCSID = 

[ 11 |CHAR() [Defaultusage = 38 8 

| 12  |CHAR() [*ALLOBJindicator = = = = 

| 13 |CHAR() [Replace 0000022 


Field Descriptions 


*ALLOBJ indicator. 


Whether a user with *ALLOBJ special authority can use the function. The default value is 1. This key can 
be specified only if the function type control key is set to 3 (administrable function). 


0 For auser with *ALLOBJ special authority to use the function, the usage information specified for 
the function must indicate that the user is allowed to use the function for one of the following 
reasons: 


1. the user is allowed usage, 
2. one of its groups is allowed usage, or 


3. the default setting is to allow usage. 


ZI A.user with *ALLOBJ special authority is always allowed to use the function. 


Default usage. The default usage for the function. The default usage is used if the user or one of its groups 
does not have a specific usage setting. This key can be specified only if the function type control key is set 
to 3 (administrable function). The default value is 2. 


I The default usage is to not allow usage of the function. 


2 The default usage is to allow usage of the function. 


Function category. The category of the function. This control is set when the function is registered and 
cannot be changed. The default value is 3. 


1 The function is a locally managed client function within iSeries Navigator. The function defines 
code that runs on the client, is locally managed, and is included in the iSeries Navigator tree 
structure. 


2 The function is a locally managed client function, not within iSeries Navigator. The function 
defines code that runs on the client and is locally managed, but is not included in the iSeries 
Navigator tree structure. 


3 The function is a host function. The function defines code that runs on the server. 


4 2 The function is a centrally managed client function within iSeries Navigator. The function defines 
code that runs on the client, is centrally managed, and is included in the iSeries Navigator tree 
structure. 


5 3 The function is a centrally managed client function, not within iSeries Navigator. The function 
defines code that runs on the client and is centrally managed, but is not included in the iSeries 
Navigator tree structure. 


#Only client based applications should use category 1, 2, 4, or 5. See Application Administration Concepts 


in the iSeries Navigator topic for more information on the difference between locally managed and 
centrally managed client functions. 


Function description. The text for the function description. The default value is blanks. 


Function description CCSID. The CCSID value associated with the function description. The default 
value is 0. 


0 The current job default CCSID value is associated with the function description. 


CCSID The CCSID value associated with the function description. The CCSID value must be from 1 
to 65535. If 65535 is specified, then the data will not be converted to the desired CCSID when 
the function is retrieved. 


Function group ID. The ID of the function group with which this function will be grouped. The function 
group must exist, have a function type of function group (2), and have the same category as the function 
being registered. If a value of *NONE is specified, then the function is not grouped under a function group. 
The default value is *NONE. This key cannot be specified if the function type control key is set to 1 
(function product). 


Function name. The text name for the function ID. The function name will be used to identify the function 
when using the iSeries Navigator Application Administration support. If this control is not specified, the 
function ID will be used to identify the function. 


Function name CCSID. The CCSID value associated with the function name. The default value is 0. 
0 The current job default CCSID value is associated with the function name. 


CCSID The CCSID value associated with the function name. The CCSID value must be from 1 to 
65535. If 65535 is specified, then the data will not be converted to the desired CCSID when the 
function is retrieved. 


Function product ID. The ID of the product for which the function is being registered. This key cannot be 
specified if the function type control key is set to 1 (function product). This key must be specified if the 
function type control key is set to 2 (function group) or 3 (administrable function). 


Function type. The type of function. This control is set when the function is registered and cannot be 
changed. The default value is 3. 


I The function is a function product. No usage information is stored for function products. The purpose 
is to group functions under a product when the functions are being administered by the iSeries 
Navigator Application Administration support. 


2 The function is a function group. No usage information is stored for function groups. The purpose is 
to group functions within a product when the functions are being administered by the iSeries 
Navigator Application Administration support. 


3 The function is an administrable function. Usage information can be stored and checked for this 
function. 


Qualified message file name and message identifier for function description. A message file and 
message identifier that contains the function description. The message file and message identifier do not 
have to exist at the time of registration. The default value is blanks. Refer to Qualified Message File Format 


for the format of this field. 


Qualified message file name and message identifier for function name. A message file and message 
identifier that contains the function name. The message file and message identifier do not have to exist at 
the time of registration. The default value is blanks. Refer to Qualified Message File Format for the format 


of this field. 


Replace. Whether to replace an existing registered function. The default value is 0. 


0 Do not replace an existing registered function. If this value is specified and the function is already 
registered, the request will fail. 


I Replace an existing registered function. If this value is specified and the function is not already 
registered, the function will be registered. If the function is already registered, only the function 
control keys that are specified on this call are replaced. Any other function control keys that were 
previously specified will keep their values. 


Qualified Message File Format 


The following table shows the layout of the qualified message file name and message identifier for the 
function name and function description fields. For a detailed description of each field, see Field 


Descriptions. 


| Offset 
| Dec Hex /|Type Field 


| 0 0 CHAR(10) Message file name 
| 10 A |CHAR(O) Message file library name 
| 20 14. |CHAR(7) Message identifier 


Field Descriptions 


Message file library name. 
The library name in which the message file resides. No special values are supported. 
Message file name. The name of the message file that contains the function name or function description. 


Message identifier. The message identifier for the function name or function description. 


Error Messages 


Message ID Error Message Text 

CPFAOAA E Error occurred while attempting to obtain space. 
CPF2225 E Not able to allocate internal system object. 

CPF222E E &1 special authority is required. 

CPF228C E Function ID &1 not valid. 

CPF228D E Function group &1 not registered in same category. 
CPF228E E Function product &1 not registered in same category. 
CPF228F E Function &1 already registered. 


CPF3C36 E Number of parameters, &1, entered for this API was not valid. 


CPF3C4D E 
CPF3C81 E 
CPF3C82 E 
CPF3C84 E 
CPF3C85 E 
CPF3C88 E 
CPF3C90 E 
CPF3CD9 E 
CPF3CDA E 
CPF3CF1 E 
CPF3CF2 E 
CPF8100 E 
CPF9810 E 
CPF9811 E 
CPF9872 E 


Length &1 for key &2 not valid. 

Value for key &1 not valid. 

Key &1 not valid for API &2. 

Key &1 required with value specified for key &2. 
Value for key &1 not allowed with value for key &2. 
Number of variable length records &1 is not valid. 
Literal value cannot be changed. 

Requested function cannot be performed at this time. 
Registration facility repository not available for use. 
Error code parameter not valid. 


Error(s) occurred during running of &1 API. 


All CPF81xx messages could be returned. xx is from 01 to FF. 


Library &1 not found. 


Program &1 in library &2 not found. 


Program or service program &1 in library &2 ended. Reason code &3. 
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Retrieve Function Information (QSYRTVFI, 
QsyRetrieveFunctionInformation) API 


Required Parameter Group: 


Continuation handle Char(20) 
Receiver variable Char(*) 
Length of receiver variable Binary(4) 
Format name Char(8) 
Function selection criteria Char(*) 
Desired CCSID Binary(4) 
Error code Char(*) 


Default Public Authority: *USE 


Service Program: QSYFNUSG 


Threadsafe: Yes 


The Retrieve Function Information (OPM, QSYRTVFI; ILE, QsyRetrieveFunctionInformation) API 
retrieves information about one or more functions. 


Authorities and Locks 


API Public Authority 
*USE 

Function Registration Lock 
*SHRNUP 


Required Parameter Group 


Continuation handle 
INPUT; CHAR(20) 


The value returned to the user in the receiver variable when only partial exit information is 
returned. This parameter must be set to blanks on the first call to this API. This parameter is used 
when more information is available to return than what could fit in the receiver variable. When you 
specify a continuation handle for this parameter, all other parameters must have the same values as 
the call to the API that generated the continuation handle. Failure to do so may result in incomplete 
or inaccurate information. 


Entries are only returned in their entirety; the API never returns anything less. If there is not enough 
space for the entire entry, the continuation handle is set to something other than blanks. 


Receiver variable 
OUTPUT; CHAR(*) 


The variable that is to receive the function information requested. 
Length of receiver variable 
INPUT; BINARY(4) 
The length of the receiver variable. If the length is larger than the size of the receiver variable, the 
results may not be predictable. The minimum length is 8 bytes. 
Format name 
INPUT; CHAR(8) 


The format of the function information to be returned. 
You must use the following format name: 


FCNIOlOO Function information 


Function selection criteria 
INPUT; CHAR(*) 


The selection criteria to be used when selecting which functions are returned. No CCSID 
normalization is performed. It is recommended that you use characters from the invariant character 
set for the comparison data. 


The information must be in the following format: 


Number of selection criteria BINARY(4) 
The total number of selection criteria. Specify 0 if no selection 
criteria are specified. The maximum value for this field is 1. 


Selection criteria array CHAR(*) 
The selection criteria. Refer to Format for Function Selection 


Criteria for more information. 


Desired CCSID 
INPUT; BINARY(4) 


The CCSID the returned text fields should be converted to. The text fields will be returned in this 
CCSID even if data loss occurs. If you want to ensure that data loss does not occur, you may 
specify 65535 or 13488 (UCS-2). 


The following can be specified for the desired CCSID: 
0 The text fields will be converted to the default CCSID for the job. 


CCSID | The text fields will be converted to the specified CCSID. The CCSID value must be 
from 1 to 65535. If 65535 is specified, then no CCSID conversion will be done on the 
text. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


FCNIO100 Format 


The following information is returned for the FCNIO100 format. This format provides information on a 
function. For a detailed description of each field, see Field Descriptions. 


| Offset 
| Dec Hex |Type Field 


[0 | 0 |BINARY@) [Bytestetumed ~~~SCS~S~S 
ae oe BINARY) [Offset to first function entry —~—~S~S~S~*S 
a0 [a8 [OAR [Reed 


Function entry information. These fields are repeated for each function entry 
returned. 


[ [| s[CHARG) —sfFunctiontype 


| [| — [CHARGO) [Function productID 
[| = [|  — [CHARC) —JFALLOBJindicator 
| |  |CHARC) [Usage information indicator 


Field Descriptions 


*ALLOBJ indicator. Whether a user with *ALLOBJ special authority can use the function. If this is not 
an administrable function, then this field is blank. 


The possible values follow: 
0 The user, its groups, or default must allow usage of the function. 


I A.user with *ALLOBJ special authority is always allowed to use the function. 


Bytes available. The number of bytes of data available to be returned. All available data is returned if 
enough space is provided. 


If the continuation handle is set to a value other than blanks, this field contains an approximation of the 
total bytes available. At a minimum, this field contains the actual number of bytes available. 


Bytes returned. The number of bytes of data returned. 

Continuation handle. The handle that is returned when more data is available to return, but the receiver 
variable is not large enough. The handle indicates the point in the repository that the retrieval stopped. If the 
handle is used on the next call to the API, the API returns more data starting at the point that the handle 


indicates. This field is set to blanks when all information is returned. 


Default usage. The default usage for the function. The default usage is used if the user or one of its groups 
does not have a specific usage setting. If this is not an administrable function, then this field is blank. 


The possible values follow: 
I The default usage does not allow usage of the function. 


2 The default usage allows usage of the function. 


Function category. Whether the function is a client or host function. 


The possible values follow: 


1 2The function is a locally managed client function within iSeries Navigator. 
2 The function is a locally managed client function, not within iSeries Navigator.*& 
3 The function is a host function. 


4 “The function is a centrally managed client function within iSeries Navigator. 


5 The function is a centrally managed client function, not within iSeries Navigator.*& 


Function description. The text for the function description. This value is converted to the CCSID value 
specified in the desired CCSID parameter. 


Function description CCSID. The CCSID value that is associated with the function description in the 
registration facility. 


Function-description message-file name. The name of the message file that contains the function 
description. If no message file name is specified, this field contains blanks. 


Function-description message-file library name. The name of the library in which the function 
description message file resides. If no message file name is specified, this field contains blanks. 


Function-description message ID. The message identifier for the function description. If no message file 
name is specified, this field contains blanks. 


Function-description message text. The first-level text for the function-description message ID. This 
value is converted to the CCSID value specified in the desired CCSID parameter. 


When the message text is retrieved from the message file, the message file library is added to the product 
portion of the library list, and *LIBL is specified for the library name. If the library cannot be added to the 
product portion of the library list, then *LIBL is still used to search for the message. If the message is not 
found, then the message file library is searched for the message. 


If no message file name is specified, this field contains blanks. 


Function-description message-text CCSID. The CCSID value that the function-description message text 
is stored in. 


Function group ID. The ID of the function group that the function is grouped with. If the function is not 
grouped with a function group, this field is set to “NONE. 


Function ID. The function ID. 


Function name. The text for the function name. This value is converted to the CCSID value specified in 
the desired CCSID parameter. 


Function name CCSID. The CCSID value that is associated with the function name in the registration 
facility. 


Function-name message-file name. The name of the message file that contains the function name. If no 
message file name is specified, this field contains blanks. 


Function-name message-file library name. The name of the library in which the function name message 
file resides. If no message file name is specified, this field contains blanks. 


Function-name message ID. The message identifier for the function name. If no message file name is 
specified, this field contains blanks. 


Function-name message text. The first-level text for the function-name message ID. This value is 
converted to the CCSID value specified in the desired CCSID parameter. 


When the message text is retrieved from the message file, the message file library is added to the product 
portion of the library list, and *LIBL is specified for the library name. If the library cannot be added to the 
product portion of the library list, then *LIBL is still used to search for the message. If the message is not 


found, then the message file library is searched for the message. 
If no message file name is specified, this field contains blanks. 
Function-name message-text CCSID. The CCSID value that the function-name message text is stored in. 
Function product ID. The ID of the product that the function is registered for. 
Function type. The type of function. 
The possible values follow: 
I The function is a function product. 
2 The function is a function group. 


3 The function is an administrable function. 


Length of function entry. The length of a function entry that is returned. This value should be used in 
determining the displacement to the next function entry. 


Number of function entries returned. The number of function entries returned. If the receiver variable is 
not large enough to hold all of the information, this number contains only the number of function entries 
actually returned. 


Offset to first function entry. The offset to the first function entry returned. The offset is from the 
beginning of the structure. If no entries are returned, the offset is set to zero. 


Reserved. An ignored field. 


Usage information indicator. Whether there is usage information defined for the function. Usage 
information is the list of users and groups that have a specific usage setting specified for the function. 
Usage information is set using the Change Function Usage Information (OPM, QS YCHFUI; ILE, 
QsyChangeFunctionUsagelInfo) API. If this is not an administrable function, then this field is blank. 


The possible values follow: 
0 There is no usage information defined for the function. 


I There is usage information defined for the function. 


Format for Function Selection Criteria 


This table shows the format for the function selection criteria parameter. For a detailed description of each 
field, see Field Descriptions. 


ffype ‘(Field == ~~ SOSOSCSC;7«;7;73 }TFCSCS*S*S*S*S*S 


Field Descriptions 


Comparison data. The data to compare to the function information. 


Comparison operator. The comparison value to be used when comparing the function information with 
the comparison data. 


The following value can be specified: 


I The comparison data equals the function information 


Function control key. The function control to be compared. Refer to Function Control Keys for more 
information. 


Length of comparison data. The length of the data to compare to the function information. The length of 
the comparison data must be valid for the function control key that is specified. 


Size of criteria entry. The size of the selection criteria entry, including this field. 


Function Control Keys 


The following table shows the valid function control keys for the key field area of the selection control 
record. For a detailed description of each field, see Field Descriptions. 


[| 2  |CHAR() | Function type 

| 3  |CHARGO) === ~~ [FunctionproductID 
[| 4 |CHARGO) == ~~ |FunctiongroupID 
[| 5  |CHARGO) = = [FunctionID 


Field Descriptions 


Function category. The category of the function. 


The possible values are: 


i Locally managed client functions within iSeries Navigator are selected. 

2 Locally managed client functions not within iSeries Navigator are selected. 
3 Host functions are selected. 

4 “Centrally managed client functions within iSeries Navigator are selected. 


2) Centrally managed client functions not within iSeries Navigator are selected. 


7 All locally managed client functions are selected. This includes all functions in 
categories | and 2. 


& All centrally managed client functions are selected. This includes all functions in 
categories 4 and 5. 


9 All client functions are selected. This includes all functions in categories 1, 2, 4, and 5. 


Function group ID. All functions that have this function group are selected. The special value of *NONE 
can be specified to select functions that do not have a function group specified. 


Function ID. The name of the functions to select. 
The following can be specified for the function ID: 
generic* All function IDs that begin with the generic string are selected. 


function ID The specific function ID is selected. 


Function product ID. All functions that have this function product are selected. 
Function type. The type of function. 
The possible values are: 

7 Function products are selected. 

2 Function groups are selected. 


3  Administrable functions are selected. 


Error Messages 


Message ID Error Message Text 

CPF2225 E Not able to allocate internal system object. 

CPF3C19 E Error occurred with receiver variable specified. 

CPF3C21E Format name &1 is not valid. 

CPF3C24 E Length of the receiver variable is not valid. 

CPF3C36 E Number of parameters, &1, entered for this API was not valid. 
CPF3C81 E Value for key &1 not valid. 

CPF3C82 E Key &1 not valid for API &2. 

CPF3C90 E Literal value cannot be changed. 


CPF3CD9 E Requested function cannot be performed at this time. 


CPF3CDA E Registration facility repository not available for use. 

CPF3CE2 E Continuation handle not valid. 

CPF3CE3 E Continuation handle no longer valid. 

CPF3CE4 E Comparison operator &1 not valid for exit program selection criteria. 
CPF3CE7 E Number of selection criteria entries not valid. 

CPF3CE9 E Length of comparison data not valid. 

CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 

CPF8100 E All CPF81xx messages could be returned. xx is from 01 to FF. 
CPF9810 E Library &1 not found. 


CPF9872 E Program or service program &1 in library &2 ended. Reason code &3. 


API Introduced: V4R3 


Top | Security APIs | APIs by category 


Retrieve Function Usage Information 
(QSYRTFUI, QsyRetrieveFunctionUsagelnfo) 
API 


Required Parameter Group: 


Receiver variable Char(*) 
Length of receiver variable Binary(4) 
Format name Char(8) 
Function ID Char(30) 
Error code Char(*) 


Default Public Authority: *USE 


Service Program: QSYFNUSG 


Threadsafe: Yes 


The Retrieve Function Usage Information (OPM, QSYRTFUI; ILE, QsyRetrieveFunctionUsageInfo) API 
retrieves usage information for a function. 


Authorities and Locks 


API Public Authority 

*USE 
Authority Required 

*SECADM special authority 
Usage Information Lock 

*SHRNUP 


Required Parameter Group 
Receiver variable 
OUTPUT; CHAR(*) 


The variable that is to receive the function usage information. 
Length of receiver variable 
INPUT; BINARY(4) 


The length of the receiver variable. If the length is larger than the size of the receiver variable, the 


results may not be predictable. The minimum length is 8 bytes. 
Format name 
INPUT; CHAR(8) 


The format of the function usage information to be returned. 
You must use the following format name: 


FNUIO100 Function usage information 


Refer to FNUIO100 Format for more information. 


Function ID 
INPUT; CHAR(30) 


The ID of the function for which usage information is being retrieved. 
Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


FNUIO100 Format 


The following information is returned for the FNUIO100 format. This format provides usage information 
for a function. For a detailed description of each field, see Field Descriptions. 


| Offset 
= c | Hex |Type Field 


| | [BIN ARY(4) [Bytes returned 

| 4 | 4 [BIN ARY(4) [Bytes available 

| 8 | 8 [BINARY(4) [Offset to first function usage entry 

| 12 | C [BIN ARY(4) [N umber of function usage entries returned 
| 16 | 10 [BINARY (4) [Length of function usage entry 

| 20 | 14 [CHAR(*) [Reserved 


Function usage entry information. These fields are repeated for each function usage 
entry returned. 


[| | — |CHARCO) —[Userprofilename == 
[| | ~~ [CHARC) ~—s([Userprofiletypee = ss— 


Field Descriptions 


Bytes available. The number of bytes of data available to be returned. All available data is returned if 
enough space is provided. 


Bytes returned. The number of bytes of data returned. 


Length of function usage entry. The length of a function usage entry that is returned. This value should be 
used in determining the displacement to the next function usage entry. 


Number of function usage entries returned. The number of function usage entries returned. If the 
receiver variable is not large enough to hold all of the information, this number contains only the number of 
function usage entries actually returned. 


Offset to first function usage entry. The offset to the first function usage entry returned. The offset is 
from the beginning of the structure. If no entries are returned, the offset is set to zero. 


Reserved. An ignored field. 
Usage setting. Whether the user profile is allowed to use the function or not. 
The possible values follow: 

I The user profile is not allowed to use the function. 


2 The user profile is allowed to use the function. 


User profile name. The name of the user profile that has a usage setting for this function. 
User profile type. Whether the user profile is a user or a group. 
The possible values follow: 


0 The user type is unknown. This value is returned if an error occurred while determining the type of 
user. 


I The user profile is a user (does not have a GID value). 


2 The user profile is a group (has a GID value). 


Error Messages 


Message ID Error Message Text 

CPF2225 E Not able to allocate internal system object. 
CPF222E E &1 special authority is required. 

CPF228A E Function &1 not registered. 

CPF229B E Operation not allowed for function &1. 
CPF3C19 E Error occurred with receiver variable specified. 


CPF3C21E Format name &1 is not valid. 


CPF3C24 E 
CPF3C36 E 
CPF3C90 E 
CPF3CD9 E 
CPF3CDA E 
CPF3CF1 E 
CPF3CF2 E 
CPF8100 E 
CPF9810 E 
CPF9872 E 


Length of the receiver variable is not valid. 

Number of parameters, &1, entered for this API was not valid. 
Literal value cannot be changed. 

Requested function cannot be performed at this time. 
Registration facility repository not available for use. 

Error code parameter not valid. 

Error(s) occurred during running of &1 API. 

All CPF81xx messages could be returned. xx is from 01 to FF. 
Library &1 not found. 


Program or service program &1 in library &2 ended. Reason code &3. 


API Introduced: V4R3 


Top | Security APIs | APIs by category 


Retrieve User Function Information 
(QSYRTUFI, QsyRetrieveUserFunctionInfo) API 


Required Parameter Group: 


Continuation handle Char(20) 
Receiver variable Char(*) 
Length of receiver variable Binary(4) 
Format name Char(8) 
User profile name Char(10) 
Function selection criteria Char(*) 
Desired CCSID Binary(4) 
Error code Char(*) 


1 
2 
3 
4 
5 
6 
7 
8 


Default Public Authority: *USE 
Service Program: QSYFNUSG 


Threadsafe: Yes 


The Retrieve User Function Information (OPM, QSYRTUFI; ILE, QsyRetrieveUserFunctionInfo) API 
retrieves usage settings for a specified user profile for one or more functions. 


Authorities and Locks 


API Public Authority 
*USE 

Authority Required (if user profile name is not *CURRENT) 
*SECADM special authority or 
*READ to the user profile 

Function Registration and Usage Information Lock 
*SHRNUP 


Required Parameter Group 


Continuation handle 
INPUT; CHAR(20) 
The value returned to the user in the receiver variable when only partial exit information is 


returned. This parameter must be set to blanks on the first call to this API. This parameter is used 
when more information is available to return than what could fit in the receiver variable. When you 


specify a continuation handle for this parameter, all other parameters must have the same values as 
the call to the API that generated the continuation handle. Failure to do so may result in incomplete 
or inaccurate information. 


Entries are only returned in their entirety; the API never returns anything less. If there is not enough 
space for the entire entry, the continuation handle is set to something other than blanks. 

Receiver variable 
OUTPUT; CHAR(*) 


The variable that is to receive the usage information requested. 
Length of receiver variable 
INPUT; BINARY(4) 


The length of the receiver variable. If the length is larger than the size of the receiver variable, the 
results may not be predictable. The minimum length is 8 bytes. 


Format name 
INPUT; CHAR(8) 
The format of the usage information to be returned. 
You must use one of the following format names: 
UFNIO/00 User function usage information 
UFNI0200_ The same information as UFNIO100, plus an indicator of where the user's usage 
setting comes from, the function name information, the function group ID, and the 
function product ID. 
UFNIO300_ The same information as UFNI0200, plus additional indicators of where the user's 
usage setting and source come from if the *ALLOBJ authority is ignored, and 


where the user's usage setting and source come from if the *ALLOBJ and specific 
usage setting are ignored. 


User profile name 
INPUT; CHAR(10) 


The name of the user profile to retrieve function usage information for. 
You may specify the following special value. 


*CURRENT The usage information for the user currently running is returned. 


Function selection criteria 
INPUT; CHAR(*) 
The selection criteria to be used when selecting which functions to return usage information for. No 
CCSID normalization is performed. It is recommended that you use characters from the invariant 


character set for the comparison data. 


The information must be in the following format: 


Number of selection criteria BINARY(4) 
The total number of selection criteria. Specify 0 if no selection 
criteria are specified. If 0 is specified, usage information for all 


registered functions will be returned. The maximum value for this 
field is 1. 


Selection criteria array CHAR(*) 
The selection criteria. Refer to Format for Function Selection 
Criteria for more information. 


Desired CCSID 
INPUT; BINARY(4) 


The CCSID that the returned text fields should be converted to. The text fields will be returned in 
this CCSID even if data loss occurs. If you want to ensure that data loss does not occur, you may 
specify 65535 or 13488 (UCS-2). 


The following can be specified for the desired CCSID: 
0 The text fields are converted to the default CCSID for the job. 


CCSID _ The text fields are converted to the specified CCSID. The CCSID value must be from 1 
to 65535. If 65535 is specified, then no CCSID conversion is done on the text. 


Error code 
1/O; CHAR(*) 


The structure in which to return error information. For the format of the structure, see Error Code 
Parameter. 


UFNIO100 Format 


The following information is returned for the UFNIO100 format. This format provides function usage 
information for a user profile. For a detailed description of each field, see Field Descriptions. 


| Offset 
ae Hex =e Field 


[ 36 | 24 |BINARYG@) [Length of functionentry ——~—~—SCS~*S 


Function entry information. These fields are repeated for each function entry 
ee 


| CHAR(30) Function ID 


| | |CHAR(1) [Usage indicator 
| | |CHAR(*) [Reserved 


UFNIO200 Format 


The following information is returned for the UFNI0200 format. This format provides function usage 
information for a user profile, plus the usage source indicator, function name information, function group 
ID, and function product ID. For a detailed description of each field, see Field Descriptions. 


| Offset 
a c | Hex |Type 


Field 
| | BINARY(4) [Bytes returned 
| 4 | 4 [BIN ARY(4) [Bytes available 
| 8 | 8 [CHAR(20) [Continuation handle 
| 28 | 1C_ |BINARY(4) [Offset to first function entry 
| 32 | 20 [BIN ARY(4) [N umber of function entries returned 
| 36 | 24 [BINARY(4) [Length of function entry 
| 40 | 28 [CHAR(*) [Reserved 


Function entry information. These fields are repeated for each function entry 
a 


; = [| —— JCHAR() [Usage indicator 
[| = { —— |CHARC) —s[Usagesouree 
[| =| — |[CHAR@) [Reserved 
[ | ~—— [CHARGO) [Function groupID- 
[| [| ss JCHARG@) Reserved 


UFNIO300 Format 


The following information is returned for the UFNI0300 format. This format returns the same information 
as format UFNI0200, plus where the user's usage setting and usage source come from if the *ALLOBJ 
authority is ignored, and where the user's usage setting and usage source come from if the *ALLOBJ 
authority and specific usage setting are ignored. For a detailed description of each field, see Field 


Descriptions. 


| Offset 
ae c | Hex |Type Field 


| | [BINARY (4) [Bytes returned 

| 4 4 BINARY(4) [Bytes available 

| 8 | 8 [CHAR(20) [Continuation handle 

| 28 | 1C [BINARY(4) [Offset to first function entry 

| 32 | 20 |BINARY(4) [N umber of function entries returned 
| 36 | 24 [BIN ARY(4) [Length of function entry 

| 40 | 28 |CHAR(*) [Reserved 


Function entry information. These fields are repeated for each function entry 
returned. 


[| = = [ — |CHAR@GO) — fFunctionID 
[| = [ — |CHAR() ~— [Usage indicator 
; = [  |CHAR() [Usage source 
| = [| ~~ |CHARC0) —__[Function-name message-file library name 
[| |GHAR@) __|Funetion-name message ID. —=~=~S~S 
[  [ _ |CHAR@30) ~~ [Function-name message text 
| | [CHAR(G3) [Reserved 

| | ~~‘ |BINARY(4) __[Function-name message-text CCSID 
[| = [ — |CHAR@30)[Functionname 
| | |CHAR(2) [Reserved 

[| | —[BINARY(4)— [Functionname CCSID- 


CHAR() Usage indicator ignoring *ALLOBJ and 
ignoring specific usage setting 

CHAR(1) Usage source ignoring *ALLOBJ and ignoring 
specific usage setting 


| | CHAR(*) Reserved 


Field Descriptions 


Bytes available. The number of bytes of data available to be returned. All available data is returned if 
enough space is provided. 


If the continuation handle is set to a value other than blanks, this field contains an approximation of the 
total bytes available. At a minimum, this field contains the actual number of bytes available. 


Bytes returned. The number of bytes of data returned. 


Continuation handle. The handle that is returned when more data is available to return, but the receiver 
variable is not large enough. The handle indicates the point in the repository that the retrieval stopped. If the 
handle is used on the next call to the API, the API returns more data starting at the point that the handle 
indicates. This field is set to blanks when all information is returned. 


Function group ID. The ID of the function group that the function is grouped with. If the function is not 
grouped with a function group, this field is set to *NONE. 


Function ID. The ID of the function. 


Function name. The text for the function name. This value is converted to the CCSID value specified in 
the desired CCSID parameter. 


Function name CCSID. The CCSID value that is associated with the function name in the function 
registration facility. 


Function-name message-file name. The name of the message file that contains the function name. If no 
message file name is specified, this field contains blanks. 


Function-name message-file library name. The name of the library in which the function name message 
file resides. If no message file name is specified, this field contains blanks. 


Function-name message ID. The message identifier for the function name. If no message file name is 
specified, this field contains blanks. 


Function-name message text. The first-level text for the function-name message ID. This value is 
converted to the CCSID value specified in the desired CCSID parameter. 


When the message text is retrieved from the message file, the message file library is added to the product 
portion of the library list, and *LIBL is specified for the library name. If the library cannot be added to the 
product portion of the library list, then *LIBL is still used to search for the message. If the message is not 
found, then the message file library is searched for the message. 

If no message file name is specified, this field contains blanks. 

Function-name message-text CCSID. The CCSID value that the function-name message text is stored in. 


Function product ID. The ID of the product that the function is registered for. 


Length of function entry. The length of a function entry that is returned. This value should be used in 
determining the displacement to the next function entry. 


Number of function entries returned. The number of function entries returned. If the receiver variable is 
not large enough to hold all of the information, this number contains only the number of function entries 
actually returned. 


Offset to first function entry. The offset to the first function entry returned. The offset is from the 
beginning of the structure. If no entries are returned, the offset is set to zero. 


Reserved. An ignored field. 
Usage indicator. Whether the user is allowed to use the function. 
This parameter contains one of the following values: 

I The user is not allowed to use the function. 


2 The user is allowed to use the function. 


Usage indicator ignoring *ALLOBJ. Whether the user is allowed to use the function if this API ignores 
the *ALLOBJ authority. 


This parameter contains one of the following values: 
I The user is not allowed to use the function. 


2 The user is allowed to use the function. 


Usage indicator ignoring *ALLOBJ and ignoring specific usage setting. Whether the user is allowed to 
use the function if this API ignores the *ALLOBJ authority and his specific usage setting. 


This parameter contains one of the following values: 
I The user is not allowed to use the function. 


2 The user is allowed to use the function. 


Usage source. An indicator as to why the user is allowed or is not allowed to use the function. 
This parameter contains one of the following values: 
I The user has *ALLOBJ special authority. 
The user has a specific usage setting for the function. 
One of the user's groups has *ALLOBJ special authority. 


2 
3 
4 One of the user's groups has a specific usage setting for the function. 
5 The default usage setting for the function was used. 

9 


The usage source could not be determined. 


Usage source ignoring *ALLOBJ. An indicator as to why the user is allowed or is not allowed to use the 
function if this API ignores the *ALLOBJ authority. 


This parameter contains one of the following values: 
2 The user has a specific usage setting for the function. 
3 One of the user's groups has *ALLOBJ special authority. 
4 One of the user's groups has a specific usage setting for the function. 
5 


The default usage setting for the function was used. 


9 The usage source could not be determined. 


Usage source ignoring *ALLOBJ and ignoring specific usage setting. An indicator as to why the user is 
allowed or is not allowed to use the function if this API ignores the *ALLOBJ authority and specific usage 
setting. 
This parameter contains one of the following values: 

One of the user's groups has *ALLOBJ special authority. 

One of the user's groups has a specific usage setting for the function. 


3 
4 
5 The default usage setting for the function was used. 
9 


The usage source could not be determined. 


Format for Function Selection Criteria 


This table shows the format for the function selection criteria parameter. For a detailed description of each 
field, see Field Descriptions. 


[type [Field ===~=~~S~CS~*=“‘“‘S;SCS~C~<‘<;73ETFTFtStSCSCS 


Field Descriptions 


Comparison data. The data to compare to the function information. 


Comparison operator. The comparison value to be used when comparing the function information with 
the comparison data. 


The following value can be specified: 


1 The comparison data equals the function information 


Function control key. The function control to be compared. Refer to Function Control Keys for more 
informaiton. 


Length of comparison data. The length of the data to compare to the function information. The length of 
the comparison data must be valid for the function control key that is specified. 


Size of criteria entry. The size of the selection criteria entry, including this field. 


Function Control Keys 


The following table shows the valid function control keys for the key field area of the selection control 
record. For a detailed description of each field, see Field Descriptions. 


Field Descriptions 


Function category. The category of the function. 


The possible values are: 


| “Locally managed client functions within iSeries Navigator are selected. 

2 Locally managed client functions not within iSeries Navigator are selected.“ 

3 Host functions are selected. 

4 2>Centrally managed client functions within iSeries Navigator are selected. 
Centrally managed client functions not within iSeries Navigator are selected. 

7 All locally managed client functions are selected. This includes all functions in 
categories | and 2. 

& All centrally managed client functions are selected. This includes all functions in 
categories 4 and 5. 

9 All client functions are selected. This includes all functions in categories 1, 2, 4, and 5. 


% 


Function group ID. All functions that have this function group are selected. The special value of *NONE 
can be specified to select functions that do not have a function group specified. 


Function ID. The ID of the functions to be selected. 
The following can be specified for the function ID: 
generic* All function IDs that begin with the generic string are selected. 


function ID The specific function ID are selected. 


Function product ID. All functions that have this function product are selected. 


Error Messages 


Message ID Error Message Text 

CPF2204 E User profile &1 not found. 

CPF229D E Operation not allowed on user profile &1. 

CPF3C19 E Error occurred with receiver variable specified. 

CPF3C21E Format name &1 is not valid. 

CPF3C24 E Length of the receiver variable is not valid. 

CPF3C36 E Number of parameters, &1, entered for this API was not valid. 
CPF3C3C E Value for parameter &1 not valid. 

CPF3C81 E Value for key &1 not valid. 

CPF3C82 E Key &1 not valid for API &2. 

CPF3C90 E Literal value cannot be changed. 

CPF3CD9 E Requested function cannot be performed at this time. 
CPF3CDA E Registration facility repository not available for use. 
CPF3CE2 E Continuation handle not valid. 

CPF3CE3 E Continuation handle no longer valid. 

CPF3CE4 E Comparison operator &1 not valid for exit program selection criteria. 
CPF3CE7 E Number of selection criteria entries not valid. 

CPF3CE9 E Length of comparison data not valid. 

CPF3CF1 E Error code parameter not valid. 

CPF3CF2 E Error(s) occurred during running of &1 API. 

CPF8100 E All CPF81xx messages could be returned. xx is from 01 to FF. 
CPF9810 E Library &1 not found. 

CPF9872 E Program or service program &1 in library &2 ended. Reason code &3. 
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